home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldgetaux.z / ldgetaux
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDGGGGEEEETTTTAAAAUUUUXXXX((((3333XXXX))))                                                      LLLLDDDDGGGGEEEETTTTAAAAUUUUXXXX((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldgetaux - retrieve an auxiliary entry, given an index
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmm....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  16.  
  17.      ppppAAAAUUUUXXXXUUUU llllddddggggeeeettttaaaauuuuxxxx((((LLLLDDDDFFFFIIIILLLLEEEE **** ldptr,  iiiinnnntttt iaux ))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _l_d_g_e_t_a_u_x returns a pointer to an auxiliary table entry associated with
  21.      _i_a_u_x.  The AUXU is contained in a static buffer.  Because the buffer can
  22.      be overwritten by later calls to _l_d_g_e_t_a_u_x, it must be copied by the
  23.      caller if the aux is to be saved or changed.
  24.  
  25.      Note that auxiliary entries are not swapped as this routine cannot detect
  26.      what manifestation of the AUXU union is retrieved. If LDAUXSWAP(ldptr,
  27.      ldf) is non-zero, a further call to _s_w_a_p__a_u_x is required.  Before calling
  28.      the _s_w_a_p__a_u_x routine, the caller should copy the aux.
  29.  
  30.      If the auxiliary cannot be retrieved, _l_d_g_e_t_a_u_x returns NNNNUUUULLLLLLLL (defined in
  31.      <<<<ssssttttddddiiiioooo....hhhh>>>>) for an object file.  This occurs when:
  32.  
  33.  
  34.      +o       the auxiliary table cannot be found
  35.  
  36.      +o       the iaux offset into the auxiliary table is beyond the end of the
  37.              table
  38.  
  39.  
  40.      Typically, _l_d_g_e_t_a_u_x is called immediately after a successful call to
  41.      _l_d_t_b_r_e_a_d to retrieve the data type information associated with the symbol
  42.      table entry filled by _l_d_t_b_r_e_a_d. The index field of the symbol, pSYMR, is
  43.      the _i_a_u_x when data type information is required. If the data type
  44.      information for a symbol is not present, the index field is _i_n_d_e_x_N_i_l and
  45.      ldgetaux should not be called.
  46.  
  47.      The program must be loaded with the object file access routine library
  48.      _l_i_b_m_l_d._a.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4).
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.